Determines the name of a user or group given the user or group ID.

OSErr PBHMapIDAsync (
    HParmBlkPtr paramBlock
);

Parameter descriptions

paramBlock

A pointer to an objParam variant of the HFS parameter block.

function result

A result code.

DISCUSSION

The relevant fields of the parameter block are:

• ioCompletion

  On input, a pointer to a completion function.

• ioResult

  On output, the result code of the function.

• ioNamePtr

  On input, a pointer to a pathname.

• ioVRefNum

  On input, a volume specification.

• ioObjType

  On input, the mapping function code; its value is 1 if you’re mapping a user ID to a user name or 2 if you’re mapping a group ID to a group name.

• ioObjNamePtr

  On output, a pointer to the user/ group name; the maximum size of the name is 31 characters (preceded by a length byte).

• ioObjID

  On input, the user/group ID to be mapped. (AppleShare uses the value 0 to signify .)

VERSION NOTES

Because user and group IDs are interchangeable under AFP 2.1 and later volumes, you might not need to specify a value in the ioObjType field.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)